home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / c / Hash_PrintStats.man < prev    next >
Encoding:
Text File  |  1989-05-15  |  2.4 KB  |  69 lines
  1.  
  2.  
  3.  
  4. Hash_PrintStats       C Library Procedures        Hash_PrintStats
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      Hash_PrintStats - print statistics about a hash table
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ##iinncclluuddee <<hhaasshh..hh>>
  15.  
  16.      HHaasshh__PPrriinnttSSttaattss(_t_a_b_l_e_P_t_r, _p_r_o_c, _c_l_i_e_n_t_D_a_t_a)
  17.  
  18. AARRGGUUMMEENNTTSS
  19.      Hash_Table   *_t_a_b_l_e_P_t_r    (in)      Table  about  which   to
  20.                                          print information.
  21.  
  22.      void         (*_p_r_o_c)()    (in)      Procedure  to  call   to
  23.                                          actually  print informa-
  24.                                          tion.
  25.  
  26.      ClientData   _c_l_i_e_n_t_D_a_t_a   (in)      Arbitrary     additional
  27.                                          argument to be passed to
  28.                                          _p_r_o_c.
  29.  
  30. _________________________________________________________________
  31.  
  32.  
  33. DDEESSCCRRIIPPTTIIOONN
  34.      HHaasshh__PPrriinnttSSttaattss prints  out  statistical  information  about
  35.      bucket  usage  in  _t_a_b_l_e_P_t_r.   The  information includes the
  36.      total number of buckets and entries in  the  table,  plus  a
  37.      histogram  indicating  how  many buckets have each different
  38.      number of entries in them.
  39.  
  40.      HHaasshh__PPrriinnttSSttaattss does not output the  statistics  information
  41.      directly.   Instead, it invokes _p_r_o_c to do the output.  Proc
  42.      must have the following calling sequence:
  43.  
  44.           void
  45.           proc(_c_l_i_e_n_t_D_a_t_a, _s_t_r_i_n_g)
  46.               ClientData _c_l_i_e_n_t_D_a_t_a;
  47.               char *_s_t_r_i_n_g;
  48.           {
  49.           }
  50.  
  51.      The _c_l_i_e_n_t_D_a_t_a parameter will be the same as the  _c_l_i_e_n_t_D_a_t_a
  52.      to  HHaasshh__PPrriinnttSSttaattss;   ostensibly it provides information to
  53.      help _p_r_o_c perform the actual I/O, such  as  channel  number.
  54.      _S_t_r_i_n_g  is a NULL-terminated string of characters containing
  55.      the statistical information.  _P_r_o_c may be invoked many times
  56.      during a single call to HHaasshh__PPrriinnttSSttaattss.
  57.  
  58.  
  59. KKEEYYWWOORRDDSS
  60.      hash table, print, statistics
  61.  
  62.  
  63.  
  64.  
  65. Sprite v.1.0         Printed:  May 14, 1989                     1
  66.  
  67.  
  68.  
  69.